home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Mission 3
/
Mission 3.zip
/
Mission 3.iso
/
tools
/
facevalu
/
docu
/
face_eng.hyp
(
.txt
)
next >
Wrap
Atari ST Guide Hypertext
|
1998-04-25
|
201KB
|
1,190 lines
Title
Introduction
Tutorial
faceVALUE principles
faceVALUE program dialogs
Menu bar
Dialog 'Main'
User window flags
About Face Value
System alerts
System requirements
Rsc information
Parameters-Dialog
Error dialog
Create a program from the RSC file
Files produced by faceVALUE
Structure of the LST file
Updating a project
Starting Face Value with commandline
Understanding the RSC file
Trees
Mandatory trees
Conditional trees
Optional Trees
Dialog trees
User-window trees
Objects
Programming with faceVALUE
How the faceVALUE engine works
How to write clean GEM programs
Hi ho, off to work we go
Window iconification
Working with windows
The RSC-file, objects and variables
The ASCII-table dialog
How to use GDOS fonts and xFSL-fontselectors
Getting keyboard-input
The error-routine
'Wrinkles' - modules for faceVALUE
'The name and the goal
'Rules for wrinkles
'Documentation
'Face Value 2.0 flags
Reference
,Reference - The resource file
-Reserved dialog names
-Sorting your dialogs
-Menu- and Dialog-Trees
0Menu - Extended type: 0
0System - Extended type: 1
0Background - Extended type: 2
0Toolstrip - Extended type: 3
0Toolbar - Extended type: 4
0ASCII-table - Extended type: 5
0Mouseforms - Extended type: 6
0Desktop - Extended type: 7
0Progress - Extended type: 8
0Busydialog - Extended type: 9
0Iconify - Extended type: 10
0PopUps - Extended type: 11
0Alert - Extended type: 12
0Alert icons - Extended type: 13
0Alert strings - Extended type: 14
0ListBox - Extended type: 15
0Animated icon - Extended type: 16
0Code - Extended type: 17
0Non-modal dialog - Extended type: 18
0Prg.modal dialog - Extended type: 19
0Toolbox - Extended type: 20
-Changes to Dialogs
FDialogs with *no* window attributes
FFoldable Dialogs
FDesktop-Dialog
FChanged: System-Dialog
-Standard objects
KText
KBoxtext
KImage
KProgdef
KIbox
KButton
KBoxchar
KString
KFtext
KFboxtext
KIcon
K(Menu)title
KCicon
-Face Value special objects
ZFrame
ZNiceline
ZUnderlined text
ZCheckbox
ZRound radiobutton
ZNumberScroller
ZRadioTextPopup
ZMenuTextPopup
ZRadioImagePopup
ZMenuImagePopup
ZRadioListbox
ZCheckListbox
ZMenuListbox
ZShortcut button
ZShortcut string
ZShortcutIcon
ZPointForward
ZShortcut boxchar
ZPointBack
ZHelp button
ZHelp menu item
ZAnimatedIcon
ZAutoCompress Icon/Image
ZCloserButton
ZQuitApp
-New objects
tSizer Object
tToolbox popup radiobuttons
tMovable objects
tDrag & drop objects
-Objects with new features
yListbox: Autolocator added (hi, Manfred! ;-)
yTear-Off Popups
yAnimated objects
-Animated icons
,Object state
~Selected - OB_STATE bit 0
~Crossed - OB_STATE bit 1
~Checked - OB_STATE bit 2
~Disabled - OB_STATE bit 3
~Outlined - OB_STATE bit 4
~Shadowed - OB_STATE bit 5
~Extended object states:
,Object flags
Selectable - OB_FLAGS bit 0
Default - OB_FLAGS bit 1
Exit - OB_FLAGS bit 2
Editable - OB_FLAGS bit 3
Rbutton - OB_FLAGS bit 4
Lastob - OB_FLAGS bit 5
Touchexit - OB_FLAGS bit 6
Hidetree - OB_FLAGS bit 7
Indirect - OB_FLAGS bit 8
Extended object flags
Shortcuts in menu-entries
,Reference - Programming
Global
Global variables list
window_array&(index&,x&)
window_tree%(index&,x&)
,Reference - User routines
Always
user_var_index
user_rsc_var_init
user_rsc_interact
user_rsc_draw_extra
user_on_open
user_on_exit
user_quit_ok
user_systemcheck
user_gem_messages
user_win_close_all
Userwindows
user_window_content
user_mouse
user_keyb
user_win_close_ok
User routines drag & drop
user_dragdrop_init
user_dragdrop_path
user_dragdrop_accept
user_dragdrop_loaddata
,Reference - Callable system routines
Using windows
win_open
win_get_workarea
win_set_infoline
win_set_slidersize
win_set_vslider
win_set_hslider
win_change_size
win_keyb_scroll
win_open_dialog
win_close_all
win_close
win_set_title
win_get_index
win_send_redraw
win_modal_enq
Iconification
win_iconify
win_iconify_all
win_uniconify
win_uniconify_all
Window cycling
win_cycle
Blitting image bitmaps
vdi_bitblt
Offscreen bitmaps (mono, NVDI/EdDI)
offscreen_open
offscreen_close
Allocate global memory
mxalloc_global
Fileselector support
selectric_load$
selectric_check
fileselector$
Getting information from the operating system
appl_xgetinfo
vq_extnd
vq_vgdos
get_cookie
clip_bootdrive$
Alerts
alert_standard
alert_wind
Blocking the screen/system
aes_screen_lock
aes_screen_unlock
aes_clear_buffers
Progress bar
progress_open
progress_update
progress_close
Busy dialog
busy_open
busy_update
busy_close
Virtual workstations
v_opnvwk
v_clsvwk
Mouse
mouse_wait
mouse_form
mouse_busy
Load and save mono IMG
img_load
img_save
Sending GEM messages to yourself
aes_internal_message
Calling ST-Guide
call_st_guide
Installing a custom desktop
desktop_new
desktop_restore
Using the GEM clipboard
clip_write$
clip_read$
Working with objects
rsrc_setup_tree
xrsrc_gaddr
rsc_ob_flags
rsc_ob_state
rsc_ob_check
rsc_ob_hide
rsc_ob_disable
rsc_free_string$
rsc_free_image_vrt_cpyfm
rsc_free_image
rsc_set_new_menu
rsc_get_code_adr
rsc_ob_draw
rsc_ob_xywh
rsc_set_text
rsc_get_text$
rsc_disable_menutitle
rsc_find_menutitle
set_cursor
Read the keyboard state
aes_get_kstate
Drag & drop protocol
fread
dd_read_args$
GDOS and xFSL support
vdi_load_fonts
vdi_unload_fonts
vst_alignment
EVNT_MULTI loop
evnt_multi_loop
faceVALUE Converter 1.0
RSC library
Example programs
EX.RSC:
IMG_VIEW.RSC
faceVALUE history
Changes to faceVALUE version 1.1
Additions
Changes, Improvements
Bug fixes
Changes to faceVALUE version 2.0
Changes after Version 2.0
$06.04.98 PL1 (HH)
$07.04.1998 PL2 (HH)
$08.04.1998 PL3 (HH)
$08.04.1998 PL4 (MS)
$11.04.1998 PL5 (MS)
$17.04.98 PL6 (HH)
$18.04.98 PL6 (MS)
$19.04.98 PL6 (MS)
$20.04.98 PL6 (HH)
$22.04.98 PL6 (MS)
$24.04.98 (HH)
$24.04.98 (MS)
Index
$Programdocumentation for faceVALUE
0Vegard Hofs
y, Holger Herzog und Manfred Ssykor
$VER: 2.0 (April 25, 1998)
Title
-i -s +z
a1V:6
l)5+S
JY|~]
kV%pTK
/sy&s
kq:c:*
rI[W7X
libh_
:hvmL
~cgUot
%FlPv
QAc2Esp(Y
EtiKL
]3U*"
soJpN
Ey>|n
/RLm,f
pZT1\n
M|Iyf
^H*[CZ
z}lO6
`~2u-!
;a|ET
rrrYa|>
4!R6-
,~'mIh
2G|1,
?o^p,
O~t;Y
1Vfmf
/{`#F
8'$&$l
W,WKJ
T5<#x
M^;iB~
`9!gL(|
5tRrD
*a rU2_
\RPv1X
}Zl;+n
dJ[4da@
.\9gM
hria~
(%E\Y
V#ad0
|~<}=
-M4|#
VYH;5
SfY"-
qqqM1
_D/q)
]:u+c+%
%0EXt;X-
>.nne(
<~,|>
J{p.H
0>RiX
{y_{y
/fY!x)+!
:NRIv
{nd7.
xcBzA&
;Ab\;
TYHy6
}yrtjsHZPM
nlb'sZ
_P s37
46TbC
!YgpF*
-Ghta
<(,ta
TG%X6}
bVJd~
h}B p
swa b
!yRC7
MA2j(;RY{
gt:r!9RR
8O>:J
;_*+$K
pZc'
^tqDp 11
#>#0x
73gN>
qqqQA
|]|`~
rj>89
Y,\,R
:)hI
M:VK&
~y&&2I
BH:^ YaM@
mU{n2
oQrZ'a
EE|J{
K Z,&C
ObY>?{
>`1 +
?GV`G
!;YHc8
aX2p0
2&_v~
UT. `X0
W+V`K)
&0,m%
zAekw
*Mxo0
r-J;d
*gZjIrqXs
)VVv.
7x6MB `
HydstD91L4
h[k&X
H-clsA
PO!aT
Ve.#mm
l3:b
Bt@t7
_[`pU
;i-eK
N>_.>_6>_
p(8uZ
{@>78:
0cPh)4
&w&1l
=5<5j
='r?]%
>sgpB
)Zq2Uu
bq)=;
+0urc
5U4p
Tz-59
_B_l#_
Yje'O
BT0 I
P+q'ow
J+iyjp-
p2mna
q&4?yc*
iOS"b
<hRT;
o:mc?
H~]q`
OGd_s
N]SZ+
s<YVk
F0k[55
l/8_p
3P_"]
IuW|q
Q~.aSV
SR@YO
CrFhQ=J
|7z`#
^^2BC
[=oAN
s@Z|4
PNY,?
m##;[
;;z2L
8AI.-2
xz|ic
XbW6#
,8Fds
2C\$$1
M&VKi<r
02k[|
nC=2#a
PF3Sbz
7JSpmTl
T/|p`
bj/J|
OjWzp|
9\fr
V5nO%]
(h4F\
FEULo
CO*F{
6plH*
*b[F%n
Y1iRw
viO?y-
~9z[xTk
Z}C-(
S-<r$}
t| 1(
,Ea0ok
*BFo`
}XuWSi
/sV=r
,r@b\
aIH:6
_V=c2$
*"00f
MkM&1lc
90V)K
wcA| f
F1i5R
7$@I
OD@Jz
mJ2{O4
YQzvg
>W2Fm
`a 5F
i( &S
Fif|
~}_Nz
w-n6a
GX;,A
V1N{S
&S3;
!AAlR!V
7'RBG ^
AjIXU=/:
|Wd9O
lT7cWmS'
l-$+R
uh&/A
%Ccj2
h}A($&
ayy6k
,x}?F<>
%Ccj2
zFK<Z
HzuR7xQ9Y
owY)-
)aiS+
#_r-3Mwy
8\LRb
/&Iyt
tDA*)
-dSwsO
Scvn`
m*4(!
w%0}?E0}~
n;6x.
1itn+
~-E7%
H{?}k
JThTAmpT
c X`jy-
T_G>)|L
Sb[lf6
YIT]qM
W1{wx
LEnz]
5+;nY}
uuv|k
,vp'a[1
C^+H*
JH95i
RS$$v
R*+Nnz
*Q@JT
XG'q<
j^2BC
nin.J
6ys,R
c/O] M&]=
rs)[\
to^w"_A
"<.?g0
{OzpUGPv)
[|#=RL
Ala0.A
{&~rq
Zp3'@<
`hC)
.@X@^
[slSO=0
\K.i>
"1=izB
+.XAu
![Dn?
d'H%C
$JI9v
X<_Y>
rd*.|f
tmJr(
T@dcO
<n,48
q u%
UiYSb
"ci%*
w&(3l
X/Iu;
"L94h
4+Q0*p
rK:4J^^
b#ZF2
@oKm]2M
+!n5g
W\*![)
PiT+c`
T<^)[
F8nxT
j$kKmd
Yjs[l
`TDSH
vxPOK}n
X*f-q
84Qpk-i_|
w^@z~
%JI^^
Zwyp:en7
T=<~<
g2)gM]5{
EwC6&
g T?X#
m5Z+G
AVJcC
jjI!xx5c
JZm}+&
%T/5K
NBe~4
sZ\ G
@/'3g
g:./i
`XH` U
d5knc
'iQ7>7
`K=I&
V`DMSLoF6d
|%JE;z
Z$TQxi
4jT41
!*ql}
7H7-a<{
,k(RG
(BSEz\
)Ho**{
]G 1(;bo
<Wpdk ,
`7@Ba
w`V~S
So8A6
j&Aghh
+q$Uc
4NF%-
;,3M"y
x 'Yv
k1\vPmJ
{xacI
;{a|"u
W9}_p
+[*T[y*
E(=79r@
94(&-
'-j:?
+IB=Z
lC\ b
i?p;_
(IS'J[p)
4?8br(f0
0M#g\G
O]v.Z
DTZEB
*rK %O%
n>8Gc
5&{0
qVf^\
;{@>^
5L3s<3
/ZBW1/f
P{ZO+
-pFW]*
&0l#HSb
TR8%=
"pr*zl
)=A<_"`
eU}h=
<~-a8iB
NuP_^
YZN_p!
U7 W0d
Q]z+;
|!fh8
5uZ5Z
;j4*m
?K:/s
gFHO+
J~47|[
$;Z0&
>HLBe
J')V]b
!-2mBT
mDfHV
P6V-)
XX,x<
>|;8~
SvQXB
,C='J
#KU2p
ipz{0
+`q!v
!j!~00
lI&q|
pa)FOD)h
!VuPP
,QQ+y
Hu `UG
vI[m-
?pND(
}(hlb
O0|Hz
Vp1fS l3
54Y}_
[=kMX{
J@}et
+xd=5
6>-uM
c-u78
\J)tFsx
BRs"Z
C#\$P
CTSr"$
K+4R]
dKNtf
]i)gph
J4Xzd
8zI?'I~$}c^
,02][@
[^'F%L
}?Dg+
]mTkAR
R/}1^#
CL\cXj
wv6x@
?n0sc
t^|DmI
%I:jl
e,$sh
+:W9`3
nf/aD
'%SH2
vKD6jd
mp[>"~n
v_g\_
RFz8s
p(mDpl
S~m*h
wD[>^v
Y,R6^
{Od3#
PVF!R
[&!s#3
7:_IF
F,:!~
D!iP2
~CiYj
Fb[Q)
p-q\G(
!s(wn
o@T'Gg
MxU|+
H yEb
xmh?L
:'=Bj
Xjjiw
R,*+3+
m)_B!
J:pLB
F&C[`Jc
6c,2
)o MT
-ah;O
n1h2)6dR
jxcQ
(DPQ4
O$6mB&`
]OUi$
;kZCA
<d(w7
2c$$v
45A&>@4
5Tr>P
}Q6<Y
`}&,F@\
|o60~N
}?3CG
7=HIJe
2{psN
A/pB*>K
x;;)T
C[) P
+ncW&
}!;_QL
(07f|
7ae!p
X"5J+
(rEl%l
6$.aW1
y4|1i4
~ 8~x
<^6%_
~yHWc
ciqNyV*?
l dK$
(r{81
JZ=?L
D5F|6
yR00/U
%I,5I
*PzWr
K"I+]
Wo{9o
g{X$G
L,|F^
eAmCJd
_{?>HN,
& 8wh(
)}mZV
^:O+\
eZ$ B
mY ZS%
$% xVFP
-w_)
l"0Xj
9@z>[x1
#F-nn
6[-[f
0% x*
}.?E6
OS@w,
[$$wk
Ln?yG
.'i@tI
Pj[x&
_*RwWR
4!*G2T
;;DHxR2
KrUc$h
4!U fLswY
E%?^C
j}2ZX
0X%QD
X~JBq
$4v.v^6
?N*rjb
R6%I
30[0(
riMZ|
v!*E)R_
$*[2^
5XB1~Y[
Efx\5
h{1stO
tvRBk
!C1n1
99tS}SM
Bj4ND?
v>W{VB
SG6%1
,4klA
T'Ao"
+QOX5^xt
QLZ4<
38juW[
/\0wm
^4d)aXI
W Stl
W`0ML
(e(rT
T,Ap[
n#'?$
ImAT1
Zj ~)
0fCBL
`/3Y4X
,aO0P[
z`[Oik
:Hjz7
ock l
*k4|-
b_@T/
;A/6U
*Vvet
N2O-Cf
olRAe
/'wdm
&S1i#
nj X Q
}mY5l
\qnXam
)/aaD
~)*\]
UfZQ \
+1jBT
g06B9
\ /^(
3{Hd$7
B=hik45
iqg&<X
^J>4td
J3+9R
M@j[>Mq
e;:Nt
.Ltsu
pI)qv
O0uj<
{^eph
`W(G%HHHZ
jZ^\c
w?Fl#
?_F_i[4
kN-N5
d*'s.
n}E-P
-#x@
l^>kdPm
n0wmr
e@#q)O
Dt89:
ksT4V
i,j:=
j~I8$
.EJuu
Z)b'e9
K*r32
vgj;V
}m l;X9~
vf5x\
w&F]H
c,(VSG
.req]
D>cw{
)iJ+W
RleQ2
m-Us3|
]Kpw7
~O+kC0ZH
T="?W
CxV(9
ju<Xna
(d v
tPB4]
5O ;w
z".%%
.bd@JvOc
EU)%m
AuU1jm
3rbcJ
~7F;>}
7|yCj3
<74M4
:0{;.
km7w~o
L|Me+
UUEYk
BN8CX3
J0S.y
)Eip\
h\o.&
+*2jf
g/c[@
RN(D/__6g
77OIq
;C0Xv
J\ aYpn
Q=rO]]
?N]SM
'<{-y
/W'Mtc
2T$~D
BU99wL
PyhX0
aw@%-
g&pQ0
sDBg
ipmU'|
yt(I2
$F/f;
`Jm3/
-)<um
(5%U~
G.):qXBE
:T71rr
*G\2LL
V8eEO&
Ie<mMJ
M1k:EpT
-:EGE
RY;P"b'
.[XUk
Fcr, p
AX(ar
iH9wM
z%T]q
}mbsJ
F7av[{~
^ :)[
7kRD$Lt
DjI*(
k;XV9
pe$XHi
pE?WQ
6.zu:eD
*H6=5w
SC_Cr
GsmRe7!,
JoUt2
;"w-5I6S9H
$ymLa
k=|bu
Ij9eVd
}}U+(
*V2N4
Iyqwbkq
(Y/0^
%rtZ#
opRPN
BI5O'
|^%MB
<+rxp{vR
/\Dr8
t+kU=
D#* Q
;}xS`
0<o ^a
p}FOH
d&\}F
J\wrJ
<vmg7
A.9cT
zrv~];
>C%:z
Kn:g5
C"="L
)j`4>
~J!Cd2
Fczzc>
3OF9D
>${h8
F(X M
V7^YpM
#_UZ{
H@h'D
l;1%h
*ox2l{
>0o{S
"kjFW]Z
yx|a|4A
j1i\R
{$?^&
M6gZv
:$`xji
l.hGW^
EQy'@
v<"`V
?^'mq]Q+Kv
NXWSW
2kQf/
f/t;C
HzQ+ta
;vvdn
E&xQl
P!);~K
b/:j_
#~E9u
yO%Bq
fax)d<H
Haf+\V
dqdQ>
[6v;
9Jz:4
"m>KtL=Zn
}sb.*
o>l "W
PaXG%
o/]V[
$eGUoc
U[Yzq
"%eJ'
]"k4f
,erVE
x[Q0,|k
)[g;]F`
7X{Pw
LhCkfIG
)JB@1
{T+{,_q
BFF=I
?~*8y9=
[\f;=GN
eVz3|
v/aVU
HgImR
I pjMho
p5fLZE
c>J]CF@
5FM#8f
(f9~j
[3vxh
%c7v}Z
of[<=
|~ |a
{nbW5?}>
/?g.$J
C}*q\
>x`_1Q
p.0p:
YZX2o
qANXz!
I!W}wn
,648Kd
~ ();
4hE'^
>4Yi>|
Gqxk#ML|
dik(m
D +s *%e$K
#Bb7x
j<Rdo
Xh;rM
Q+4V>a
./lqz
%-OC52y
AH=[(
$Re$s
J;ygd
0Ug~^
Bd1<p
,f3#a
1}:L-
~yX~y
,tB@LCIEG~
6&yrV
Qf0>OE
Mdh$z
s,f#^
Lno-T&,
.P*|1
heD |DCf
afDT3
2O>*)
S:@5o
/~^[MrL
jPF`fD
gF3:1
[3C_Y
RNU2k
Wso!N
mYF|>z
[@$DF6
7qeTx
Ro8>S
cabs(
3V54G
9jqkY
^<9(;
<y82o
BHON\
oprNB
|0^@@<
Vt=(G!
%nXBQ
uO7koZa,W
68X!z
,bQ)%7
?6}:&
NKN_)b
t-/o2V
Db2mj1
82 vl
Kk;YF`U
DXD\F
ZO(`^+
[{?{}
oV>H?
%NNK~
>@U/+h
i=]UuP
l?QYOC
4ny[f:
--}FZ
/C&?T
j>w70_
8s/GJ
zhj+^?